home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / proto10.arc / PROTOMAN.DOC < prev    next >
Text File  |  1990-08-24  |  17KB  |  458 lines
  1.  
  2.  
  3. ╔════════════════════════════════════════════════════════════════════════════╗
  4. ║                     ProtoMan 1.0ß External Documentation                   ║
  5. ╚════════════════════════════════════════════════════════════════════════════╝
  6.  
  7. Program      : ProtoMan
  8.  
  9. By           : John M. Setzler, Jr.
  10.  
  11. Release Date : September 1st, 1990
  12.  
  13. Version      : 1.0ß
  14.  
  15. Status       : Shareware
  16.  
  17. ─────────────────────────────────────────────────────────────────────────────
  18.  
  19. PROGRAM DESCRIPTION:
  20.  
  21.  
  22.      ProtoMan  is an external protocol shell utility designed for
  23. use with Procomm, Procomm Plus, Qmodem, Telix, and other communications
  24. software.  ProtoMan allows the user to have easy access to the DSZ
  25. protocol set (Zmodem,etc.) as well as several other external protocols
  26. such as Puma, Lynx, etc.
  27.  
  28.  
  29. DISCLAIMER:
  30.  
  31.  
  32.      ProtoMan  has been researched and developed with extensive
  33. precaution and testing.  At the time of release, there are no known
  34. existing bugs in the program but unforseen problems may arise with
  35. non-standard hardware and software configurations.  The author of this
  36. program will accept no responsibility for damage or data loss incurred
  37. by use of this program (although there should be none).  In order to
  38. prevent unforseen problems from arising, you should read this
  39. documentation completely.
  40.  
  41.  
  42. LICENSE AGREEMENT:
  43.  
  44.  
  45.      ProtoMan 1.0ß and all future releases are to be distributed under
  46. the concept of SHAREWARE.  This program is not free!  You are hereby
  47. licensed to use this program for a trial period of 30 days free of
  48. charge.  If, after 30 days, you decide that you would like to continue
  49. using ProtoMan, you must complete the registration form and return it
  50. to the author with the required registration fee enclosed. Please feel
  51. free to distribute ProtoMan to your friends and local BBSes as long as
  52. all of the files in this archive are included and unmodified.
  53.  
  54.  
  55. LICENSE AGREEMENT FOR SHAREWARE DISTRIBUTORS:
  56.  
  57.  
  58.      Shareware distributors may distribute this program as seen fit as
  59. long as the author has been notified prior to ANY distribution.  The
  60. "per disk" charge may not exceed $10 and the shareware distributor
  61. charge will not change the above license agreement for the end user of
  62. ProtoMan.  End users are not exempt from the ProtoMan registration fee.
  63.  
  64.  
  65. NOTE FOR SYSOPS:
  66.  
  67.  
  68.      If you are a sysop and would like to become a registered
  69. distribution site for ProtoMan, you should complete the Sysop's
  70. Registration Form included in this archive and return it to the author.
  71. As a registered distribution site for ProtoMan, you will receive a free
  72. registration of ProtoMan and the author will automatically upload new
  73. releases to your BBS.  Your BBS name and number will appear in the
  74. documentation of future releases of ProtoMan and be listed as a "pick
  75. up" site for ProtoMan.  In return for the free registration of ProtoMan,
  76. the author asks that you post a public message to all of your users
  77. announcing each new release of ProtoMan.  The author of ProtoMan reserves
  78. the right to refuse any BBS as a distribution site.
  79.  
  80.  
  81. ****************************************************************************
  82. ****************************************************************************
  83.  
  84.  
  85.  
  86. INSTALLING PROTOMAN:
  87.  
  88.  
  89.  
  90.      Place the ProtoMan distribution files in your communications
  91. software subdirectory and follow these instructions for installation:
  92.  
  93.  
  94.  
  95.      Before using ProtoMan with your communications software, you will
  96. need to run the INSTALL.EXE program so that ProtoMan can record some
  97. important information about your hardware.  If you are installing this
  98. program for the first time you will need to run INSTALL and select
  99. option 1 for initial installation.  You will be prompted for the
  100. following information:
  101.  
  102.                 Your Name
  103.  
  104.                 1. Baud Rate
  105.                 2. Com Port
  106.                 3. UL Directory
  107.                 4. DL Directory
  108.  
  109. When you are prompted for your name, you will need to enter it in a way
  110. that you will be able to remember because the registration number will
  111. be partially based on what you enter here!
  112.  
  113. The acceptible responses for "Baud Rate" are: 300,1200,2400,4800,9600,
  114. 19200, or 38400.  Documentation for each of the individual protocol
  115. packages will give you complete descriptions of supported baud rates.
  116.  
  117. The acceptable responses for "Com Port" are: 1,2,3, or 4.  Supported com
  118. ports will also be documented by each individual protocol package.  Some
  119. non-standard com ports may not be supported.
  120.  
  121. The "UL Directory" will represent the default path for uploaded files.
  122. This is the path which ProtoMan will look for files that you wish to
  123. upload.  A trailing "\" will be required on your path.  Example:
  124.  
  125.                 C:\UPLOAD\
  126.  
  127. The "DL Directory" will represent the default path for downloaded files.
  128. This is the path in which ProtoMan will place downloaded files.  A
  129. trailing "\" will be required on this path also.  Example:
  130.  
  131.                 C:\DOWNLOAD\
  132.  
  133.  
  134. After this information has been recorded, you will be prompted to enter
  135. the IRQ that you wish to use.  If you do not know what IRQ you will be
  136. using, I have provided a standard IRQ and you should select the standard
  137. if you are unsure of this.  The IRQ information is only good for the
  138. Zmodem file transfers...
  139.  
  140.  
  141. After you have properly entered the above information, the INSTALL
  142. program will create two new files on your disk.  The first file
  143. (PROTOMAN.CFG) will contain several pieces of information that MUST NOT
  144. be tampered with!!  The serial number for your individual copy and the
  145. space for the matching registration number will reside in this file.
  146. The second file will be called PROTOMAN.000 and this file will contain a
  147. collection of command line parameters to be used with the various
  148. protocols that ProtoMan will provide.  DO NOT attempt to edit these
  149. files manually!!  I have included an "Edit Configuration" option in the
  150. INSTALL program that will allow you to change any necessary options and
  151. it will also allow you to install your registration number in the
  152. future.
  153.  
  154.  
  155.  
  156. ****************************************************************************
  157. Files you will need
  158. ****************************************************************************
  159.  
  160. You will need the following files to go with your ProtoMan Package:
  161.  
  162.    DSZ.COM        - Zmodem protocol engine
  163.    PUMA.EXE       - Puma protocol engine
  164.    JMODEM.EXE     - Jmodem protocol engine
  165.    LYNX.EXE       - Lynx protocol engine
  166.    MLINK16.COM    - MegaLink protocol engine
  167.  
  168. If you do not have these files, you will need to obtain copies of them
  169. from your local BBS.  All of these files are always available on my BBS.
  170.  
  171.      The Momentary Lapse of Reason BBS : (704) 327-6361 : 300-38400 Baud
  172.  
  173. After you have the above files, just place them in the directory where
  174. your ProtoMan files reside and you are ready to go!!!
  175.  
  176.  
  177. ** ProtoMan DOES NOT override any capabilities of the protocols that it
  178. supports!  You need to read the documentation for each individual
  179. protocol to gain understanding about it's capabilities.  ProtoMan is
  180. merely a gateway to these protocols!!
  181.  
  182.  
  183. RUNNING PROTOMAN:
  184.  
  185.  
  186.         The first choice you will need to make is how you wish to
  187. execute the ProtoMan program once you are online with your favorite BBS.
  188. Most communications packages have a set of hot key utilities that are
  189. good for running this type of program.  If you do not wish to use a hot
  190. key to activate ProtoMan, you can simply shell to DOS from your terminal
  191. program and execute ProtoMan.
  192.  
  193.  
  194. ***  Please check your communications software manuals for instructions
  195.      on using hot keys.  Future releases of ProtoMan will include
  196.      tips for installation with different packages.
  197.  
  198.  
  199.  
  200. THE MENU SYSTEM:
  201.  
  202.  
  203.         When ProtoMan is executed, the main menu will be displayed.  The
  204. first option in the main menu is:
  205.  
  206.         RE-CONFIGURE PROTOMAN
  207.  
  208. This option will allow you to edit your registration number, baud rate,
  209. com port, and default directories in case you should ever make a
  210. hardware change on your system.  This is also the option you should
  211. select when you get your registration number.
  212.  
  213. ************
  214. WARNING!!!!!
  215. ************
  216.  
  217. Do NOT run the initial installation procedure more than once!  When you
  218. send in your registration form, you will be asked to include your serial
  219. number.  If the serial number that you send me does not match your
  220. actual serial number, your registration code will not work!!  A new
  221. serial number is created each time you choose "Initial Installation."
  222. MAKE BACKUPS!!!!
  223.  
  224.  
  225. The second option is:
  226.  
  227.         UPLOAD A FILE
  228.  
  229. This option brings up the protocol selection menu and allows you to
  230. select the appropriate transfer protocol.  After you have selected the
  231. protocol that you wish to use, you will be prompted to enter the file
  232. name to be uploaded.  This file MUST reside in the default upload
  233. directory that you specified during the installation process.
  234.  
  235.  
  236. The third option is:
  237.  
  238.         DOWNLOAD A FILE
  239.  
  240. This option is the same as the above but in the other direction!
  241.  
  242.  
  243. The fourth option is:
  244.  
  245.         SHELL TO DOS
  246.  
  247. This option allows the user to temporarily suspend the ProtoMan
  248. operations and execute DOS commands.  EXIT will return the user to
  249. ProtoMan.
  250.  
  251.  
  252. The fifth option is:
  253.  
  254.         QUIT
  255.  
  256. This should be self explanatory.
  257.  
  258.  
  259. **********************************************************************
  260. Registering your Copy:
  261. **********************************************************************
  262.  
  263. To make your copy of ProtoMan run in the registered mode, you will need
  264. to choose "Re-Configure" from the ProtoMan main menu screen and change
  265. the registration number to the number that I give you on your
  266. registration form.
  267.  
  268.  
  269. **********************************************************************
  270. Using Zmodem
  271. **********************************************************************
  272.  
  273.         You will need to refer to the Zmodem documentation files for
  274. information about unregistered copies of DSZ.COM.  DSZ will ignore any
  275. specified default UL/DL directories unless the software is registered.
  276.  
  277.  
  278.  
  279. *********************************************************************
  280. Installing ProtoMan with Procomm Plus
  281. *********************************************************************
  282.  
  283. For those of you who are using ProtoMan with Procomm Plus communications
  284. software, you need to follow these simple instructions:
  285.  
  286.    1.  Place the ProtoMan files and the external protocol engines in
  287.        your Procomm subdirectory.
  288.  
  289.    2.  Start the Procomm Plus software and choose the ALT-S setup option
  290.  
  291.    3.  Highlight and press ENTER on the FILE/PATH OPTIONS selection.
  292.  
  293.    4.  Set option "E" or option "F" to say PROTOMAN.
  294.  
  295.    5.  Call your favorite BBS and start your file transfer.  Now, press
  296.        ALT-J or ALT-U (depending on which choice you selected in the
  297.        FILE/PATH OPTIONS setup and ProtoMan will execute!!
  298.  
  299. *********************************************************************
  300. Installing ProtoMan with Qmodem
  301. *********************************************************************
  302.  
  303. For those of you who are using ProtoMan with the Qmodem communications
  304. software, there are two methods of installing the ProtoMan software.
  305.  
  306. One is as a File Transfer Protocol, set up using the ALT-N/P menu
  307. with ProtoMan installed as a Pgup/Pgdn selected option.  
  308.  
  309. The second method is by installing the ProtoMan program as a shell,
  310. using the ALT-J setup option, and then attaching the program to the
  311. desired "Hot Key".  The Hot Key method will save keystrokes.
  312.  
  313. Depending on the option you choose, you need to follow these simple 
  314. instructions:
  315.  
  316.    1.  For either installation, place the ProtoMan files and the external 
  317.        protocol engines in your Qmodem subdirectory.
  318.  
  319. To install under the Pgup/Pgdn setup:
  320.  
  321.    2.  Start the Qmodem software and choose the ALT-N/P setup option.
  322.  
  323.    3.  Highlight and press ENTER on an available lettered space.
  324.  
  325.    4.  Set options as desired, but install the Upload/Download batch
  326.        files as Protoman.exe.  Both uploads and downloads will be handled 
  327.        from this command file.  Save your setup options as normal.
  328.  
  329.    5.  Call your favorite BBS and start your file transfer.  Now, press
  330.        Pgup/Pgdn and ProtoMan will execute!!
  331.  
  332. To install as a "Hot Key" operated shell:
  333.  
  334.    2.  Start the Qmodem software and choose the ALT-J setup option.
  335.  
  336.    3.  Choose the desired Hot Key catagory from the list of available 
  337.        options.
  338.  
  339.    4.  Assign a definition for the desired Function Key.
  340.        Use one of the following syntax's:
  341.        
  342.        @SHELLX path\protoman.exe
  343.        This will operate the ProtoMan.exe file, and return you to the 
  344.        Qmodem/online state immediately upon completion of the file transfer.
  345.  
  346.                                     or
  347.  
  348.        @SHELL path\protoman.exe
  349.        This will operate the ProtoMan.exe file, and then wait for your
  350.        keystroke input before returning to the online state.
  351.  
  352.    5.  Call your favorite BBS and start your file transfer.  Now, press
  353.        the "Hot Key", and ProtoMan will execute!!
  354.    
  355. *********************************************************************
  356. Installing ProtoMan with Telix
  357. *********************************************************************
  358.  
  359.  
  360.  
  361. *********************************************************************
  362. Installing ProtoMan with Boyan
  363. *********************************************************************
  364.  
  365.  
  366.  
  367. **********************************************************************
  368.  Special thanks to the following people
  369. **********************************************************************
  370.  
  371. ** Willie Robinson **
  372. 2613 Louis Blvd.
  373. Hephzibah, Georgia 30815
  374.  
  375.  
  376.          Willie Robinson provided me with a registered copy of his ANSI
  377. screen editor "Screen Debut" to use to create all the color screens that
  378. are used in ProtoMan.  Screen Debut is shareware and is available on the
  379. following BBSes:
  380.  
  381.                The Momentary Lapse of Reason BBS
  382.                Hickory, North Carolina
  383.                (704) 327-6361 : 300-38400 Baud
  384.  
  385.                Jack's Board
  386.                Augusta, Georgia
  387.                (404) 798-4006
  388.  
  389.         Screen Debut is an ANSI screen editor that will allow you to
  390. create screens and save them in ANSI, ASCII, Pascal, C, Basic, and other
  391. formats.  This program saved me a lot of coding time!!
  392.  
  393.  
  394. ** Kurt Schmidt **
  395.  
  396.         Special thanks is in order for Kurt for his long hours of Beta
  397. testing with ProtoMan.
  398.  
  399.  
  400. **********************************************************************
  401. Getting Help or New Releases
  402. **********************************************************************
  403.  
  404.         ProtoMan is always available for download on The Momentary Lapse
  405. of Reason BBS : (704) 327-6361 : 300-38,400 Baud.  The sysop (author of
  406. ProtoMan) will always try to answer any questions that you may have
  407. about the program.
  408.  
  409.  
  410. **********************************************************************
  411. ProtoMan Distribution Sites
  412. **********************************************************************
  413.  
  414. The latest releases of ProtoMan will always be available on the
  415. following BBSes as soon as they are released:
  416.  
  417.  
  418. 1. The Momentary Lapse of Reason BBS     : (704) 327-6361
  419.                                            Hickory, NC
  420.                                            300-38,400 Baud
  421.                                            Sysop - John Setzler
  422.                                                  * ProtoMan Author *
  423.  
  424. 2. The PowerLine BBS                     : (315) 865-4070
  425.                                            Marcy, NY
  426.                                            300-2400 Baud
  427.                                            Sysop - Joe Mezzanini
  428.  
  429. 3. The Software Exchange                 : (717) 243-9620
  430.                                            Carlisle, PA
  431.                                            300-2400 Baud
  432.                                            Sysop - Bob St. Cyr
  433.  
  434.  
  435.  
  436. **********************************************************************
  437. Program History
  438. **********************************************************************
  439.  
  440.  
  441. 06/15/90
  442.  
  443.      ProtoMan Development began
  444.  
  445.  
  446. 08/16/90
  447.  
  448.      ProtoMan 1.0 Beta Released to the public.
  449.  
  450. 08/18/90
  451.  
  452.      ProtoMan bugs fixed - Problem with HyperProtocol downloading and
  453. problem with 38,400 baud configurations.
  454.  
  455.  
  456.  
  457.  
  458.